home *** CD-ROM | disk | FTP | other *** search
/ The Game Master (3rd Edition) / The Game Master 3rd edition.iso / files / musieech / calliope / cmv.doc < prev    next >
Text File  |  1993-01-11  |  28KB  |  623 lines
  1.  
  2.  
  3.  
  4.                            CALLIOPE MUSIC VISION
  5.                            -=-=-=-=-=-=-=-=-=-=-
  6.             Copyright (c) 1992 Melvin Douglas All Rights Reserved
  7.                        Single-Track Midi Music Player
  8.                                   for the
  9.                           Sound Blaster Sound Card
  10.                           Version 1.7 January 1993
  11.                                  Shareware
  12.                              FAX (516)-533-2633
  13.  
  14.  
  15. Purpose:  Single Track Midi Music Player for Sound Blaster Owners.
  16.  
  17.  
  18. -----------
  19. LEGAL STUFF:
  20. -----------
  21.  
  22.     CALLIOPE MUSIC VISION software is hereafter referred to as CALLIOPE.
  23.  
  24.     Users of CALLIOPE must accept this disclaimer of warranty:
  25.  
  26.     "CALLIOPE  IS  SUPPLIED AS IS.   THE AUTHOR DISCLAIMS  ALL  WARRANTIES,
  27.     EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION,  THE WARRANTIES OF
  28.     MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.   THE AUTHOR ASSUMES NO
  29.     LIABILITY FOR DAMAGES,  DIRECT OR CONSEQUENTIAL,  WHICH MAY RESULT FROM
  30.     THE USE OF CALLIOPE."
  31.  
  32.     CALLIOPE IS A "SHAREWARE PROGRAM"  AND IS PROVIDED AT NO CHARGE TO  THE
  33.     USER  FOR EVALUATION.   FEEL FREE TO SHARE IT WITH YOUR  FRIENDS,   BUT
  34.     PLEASE DO NOT GIVE IT AWAY ALTERED OR AS PART OF ANOTHER SYSTEM.    THE
  35.     ESSENCE  OF "USER-SUPPORTED"  SOFTWARE IS TO PROVIDE PERSONAL  COMPUTER
  36.     USERS  WITH QUALITY SOFTWARE WITHOUT HIGH PRICES,  AND YET  TO  PROVIDE
  37.     INCENTIVE FOR PROGRAMMERS TO CONTINUE TO DEVELOP NEW PRODUCTS.   IF YOU
  38.     FIND  THIS  PROGRAM  USEFUL AND FIND THAT YOU ARE  USING  CALLIOPE  AND
  39.     CONTINUE TO USE CALLIOPE AFTER A 21 DAY TRIAL PERIOD,  YOU MUST MAKE  A
  40.     REGISTRATION PAYMENT OF $20.00 U.S DOLLARS.
  41.  
  42.     REGISTERED USERS WILL RECEIVE 100 + CONVERTED "ROL" FILES FOR USE WITH
  43.     CALLIOPE MUSIC VISION...READY TO PLAY - FREE.
  44.  
  45.        To register this copy, print and complete the REGISTER.FRM file
  46.        and send it along with the registration fee of $20 directly to:
  47.  
  48.                            Melvin Douglas
  49.                            Post Office Box 141
  50.                            Uniondale, New York
  51.                            11553-0141
  52.  
  53.     Adlib is a registered trademark of Adlib inc. or it's current owners.
  54.     Sound Blaster is a registered trademark of Creative Labs Inc.
  55.     QuickBasic is a registered trademark of Microsoft Corp.
  56.  
  57.                PROGRAM FILES:
  58.                -------------
  59.                CMV.EXE       - Calliope program
  60.                CMV.DOC       - Calliope documentation
  61.                REGISTER.FRM  - Registration form
  62.                CALLIOPE.SAV  - "Saved" session filename (created by the user)
  63.                ROL2MIDI.EXE  - Conversion utility program
  64.                STANDARD.BNK  - Instrument file (needed for .ROL conversion)
  65.                *.ROL         - "Practice" .ROL files
  66.                *.MDI         - Several "ready-to-play" midi music files
  67.                FILE_ID.DIZ   - BBS file description text
  68.                VENDOR.DOC    - Vendor distribution agreement
  69.  
  70. Note: A music file with the extension ".ROL" is an Adlib format sound file.
  71. ".ROL"   files may be found on almost any Bulletin Board system or  may  be
  72. purchased from many of the shareware distributors.  "ROL" files are usually
  73. accompanied by a BANK file (i.e., STANDARD.BNK).   Bank files hold the data
  74. for  the various instruments used by the music file.   A BANK file will  be
  75. required in order to perform conversions from ROL to MDI format.   Once you
  76. have  converted  to  MDI format,  the BANK files  are  no  longer  reuired.
  77.  
  78. In  case you don't read any further,  note that you may use any key on  the
  79. command  line  as a switch to bypass the opening screen:  i.e.,   "CMV  X".
  80.  
  81. ------------------
  82. ABOUT THIS PROGRAM: (...and how to create music files)
  83. ------------------
  84.  
  85. Thank you for trying CALLIOPE MUSIC VISION (CMV).  This program was created
  86. for use with a Sound Blaster sound board.   It will play single track  Midi
  87. compatible music files.  Included with CALLIOPE is a program (ROL2MIDI.EXE)
  88. which  allows  you  to easily convert a .ROL file into  a  Midi  compatible
  89. (.MDI) file, which is a type 0 midi.   CALLIOPE IS NOT CRIPPLED IN ANY WAY.
  90.  
  91. To convert any .ROL file to MIDI format you will need the following:
  92.  
  93.  1 - The .ROL file(s) to be converted into MDI format.
  94.  2 - The BANK file (instrument file, i.e., STARDARD.BNK, BIGBANK.BNK, etc.)
  95.  
  96.  Then do the following from the DOS prompt:
  97.  
  98.    C>ROL2MIDI filename /Bbankfile /Onewfile
  99.  
  100.    for example, to convert ROCKNROL.ROL to ROCKNROL.MDI using the
  101.    STANDARD instrument bankfile: (.ROL files require Instrument bank files)
  102.  
  103.    C>ROL2MIDI rocknrol.rol /Bstandard.bnk /Orocknrol.mdi
  104.  
  105.    Note: Case is sensitive.
  106.  
  107. The  resulting  file is the only format that CALLIOPE  will  recognize  and
  108. play.   MDI files do not require Bank (.BNK)  or instrument files once they
  109. have been converted from their .ROL format into single track Midi's.    All
  110. of  the  musical information is self contained in a  single  compact  file.
  111.  
  112. Several  pre-converted  files are included so that you may  experience  the
  113. "Sight and Sound" of CALLIOPE immediately.  Simply copy all of the CALLIOPE
  114. files  into  a  separate  directory  and  type  CMV  (then  press   ENTER).
  115.  
  116. IF YOU DECIDE TO REGISTER, YOU WILL RECEIVE OVER 100 PRECONVERTED FILES.
  117.  
  118. ---------------------
  119. HARDWARE REQUIREMENTS:
  120. ---------------------
  121.  
  122.     o  An IBM PC/XT/AT/386/486 or true "compatible" running
  123.        MS-DOS or PC-DOS 3.0 or later.
  124.  
  125.     o  640K System Memory.
  126.  
  127.     o  CGA/EGA/VGA Video Adaptor.
  128.        Note that screen activity may be sluggish on a CGA equipped
  129.        XT system.
  130.  
  131.     o  One floppy disk drive or hard drive.
  132.  
  133.     o  A Sound Blaster Sound board.
  134.  
  135.     NOTE: No "drivers" are required to run CMV.
  136.  
  137. ----------
  138. BACKGROUND:
  139. ----------
  140.  
  141. Like  many  others before me,  when I first purchased my  sound  board,   I
  142. rediscovered all of my old games which supported sound, and seemingly my PC
  143. was  a whole new thing again.   Then,  I became interested in  the  board's
  144. ability to play music (or simulate playing music).
  145.  
  146. Most of the available music players were good, but I found that I wanted to
  147. know more about the music that was playing...not just the filename and it's
  148. size.    I  also  wanted a display that was  dynamic  rather  than  static,
  149. something  that presented me with lots of information,  and I  wanted  more
  150. control of the file selection process too.
  151.  
  152. But there were so many music formats...rol's, mid's, mod's, cmf's and more.
  153. For some reason "Midi"  music appealed to me,  but programs that play  Midi
  154. music  were  mostly  for  multiple track Midi's  (.MID  files  -  Type  1).
  155.  
  156. Single  track  Midi's (.MDI - Type 0)  can be created  from  existing  .ROL
  157. files.   There must be a "bizillion" rol files in the world, so this format
  158. already   has   a   large  base  of  available   music   to   support   it.
  159.  
  160. Those are some of the reasons CALLIOPE was created.   Here is a list of the
  161. features that CALLIOPE will provide.   I hope you like them well enough  to
  162. make CALLIOPE your favorite Music Player.
  163.  
  164. --------
  165. FEATURES:
  166. --------
  167.  
  168.      MAIN FEATURES:
  169.  
  170.   -  Play up to 1000 songs, start to finish.
  171.   -  Play a single song from the command line.
  172.   -  Play any number of songs continuously.
  173.   -  Execute single or double replays instantly, or delayed.
  174.   -  Save your session to a disk file.
  175.   -  View the music names in the Queue.
  176.   -  Play a "saved" session.
  177.   -  Screen Saver option
  178.  
  179.   File Selection Via a Popup scrolling window, plus:
  180.   --------------------------------------------------
  181.  
  182.   -  Sort files by Name, Size or Date.
  183.   -  Tag or un-tag single files or ALL files.
  184.   -  Support for 1000 tagged files.
  185.  
  186.   A Play-Mode screen which provides the following information:
  187.   -----------------------------------------------------------
  188.  
  189.   -  Shows the amount of available conventional memory.
  190.   -  The I/O port address and IRQ location of your sound board.
  191.   -  Name of the current directory and or sub-directory.
  192.   -  Name of the music currently playing displayed in a scrolling panel.
  193.   -  Name of the next three music files that are in the Music Queue.
  194.   -  The total number of selections that you have made.
  195.   -  The number of selections remaining to be played.
  196.   -  The number of the current selection.
  197.   -  The elapsed time for the current selection.
  198.   -  The number of loops played if Music-Loop mode is active.
  199.   -  The ESTIMATED time for all remaining songs to be played.
  200.   -  The status of the AutoReplay toggle.
  201.   -  The status of the MusicLOOP toggle.
  202.  
  203.      Note that the word ESTIMATED is emphasized.  Time estimates are
  204.      based on an average-bytes-per-minute and readjust for each new song.
  205.      It may be off by plus or minus 5 minutes (or more).  It's only an
  206.      estimate.  Also note that all number counts STOP during a REPLAY and
  207.      continue when regular play is resummed.
  208.  
  209.   File Buffer Information:
  210.   -----------------------
  211.  
  212.   -  The current size of the buffer.
  213.   -  The byte currently being processed in the buffer (ascending).
  214.   -  The percentage of the buffer already processed.
  215.   -  The mode of the current music: MELODIC or PERCUSSIVE.
  216.  
  217.   A Status window to advise you of any changes:
  218.   --------------------------------------------
  219.   -  The Status Window will keep you advised of program changes or errors.
  220.   -  In addition, the lower portion of the Status Window will advise you
  221.      if AutoReplay is active or not, since it is a delayed command.
  222.   -  Plus various symbols to provide an alternate measure of music duration.
  223.   -  Pointer-bar graphics across the top 2 rows track the music duration and
  224.      the session duration.
  225.  
  226.   Active Play Controls are as follows:
  227.   -----------------------------------
  228.  
  229.   -  Pause the music.
  230.   -  Continue music from a paused state.
  231.   -  Skip the current music (immediate).
  232.   -  Interrupt music and Replay the CURRENT song.  This may be INSTANTLY
  233.      or DELAYED and SINGLE or DOUBLE plays.
  234.   -  Music-Loop mode locks the entire session in for continuous replay.
  235.      This is also a reversable TOGGLE command.
  236.   -  Cancel music play mode and return to the Main Menu.
  237.   -  Cancel music play mode and return to the File Selection Window.
  238.   -  During a REPLAY you may Pause, Continue, Exit or Cancel the REPLAY.
  239.   -  Determine the song in the "nth" Queue position (upto the 9th position)
  240.  
  241. -----------------
  242. CALLIOPE COMMANDS:
  243. -----------------
  244.  
  245. I  tried to make CALLIOPE as intuitive as possible so that you can  use  it
  246. "right out of the box".   However,  all software should contain at least  a
  247. brief   explanation   of   the  available  commands,   so   here   it   is:
  248.  
  249. When  CALLIOPE is first invoked,  the file selection window will popup  and
  250. search the current directory for all files with an extension of .MDI,   and
  251. will  present  a list of these files within this window.   If  no  matching
  252. files  are  found,  CALLIOPE will notify you of this via  a  popup  message
  253. window,   allowing you to return to the DOS prompt.   While the  files  are
  254. displayed, you may scroll the window up or down to view, select or deselect
  255. files. Selected files are marked with a Musical Note symbol for easy recog-
  256. nition.
  257.  
  258. --------------------
  259. COMMAND LINE OPTIONS:
  260. --------------------
  261.  
  262. You may play a single song from the command line by typing the program name
  263. followed by a space, and the name of the selection.  For example, to listen
  264. to RAINYDAY.MDI, simply type CMV RAINYDAY.MDI (the file extension "MDI"  is
  265. optional).    Upon  completion,  you will be returned to  the  DOS  prompt.
  266. IMPORTANT  NOTE:   If  for  some reason you  exit  the  music  before  it's
  267. completion and you find that a "stray"  note refuses to end,  you may  type
  268. "CMV  RESET"   from the command line to "kill"  the noise.    You  will  be
  269. returned  to  the  DOS  prompt immediately  after  CALLIOPE  silences  your
  270. speakers or headphones.
  271.  
  272. As mentioned earlier, any single alphanumeric character on the command line
  273. will allow you to bypass the opening screen ie.,  "cmv z", where "z" may be
  274. any printable letter or number.
  275.  
  276. ----------------
  277. ALT + M Command: - File Selection Window:
  278. ----------------
  279.  
  280. The File Selection Window will AUTOMATICALLY POP-UP upon first invocation
  281. of the program.  On slower machines, this may take a second or two.  Other-
  282. wise, you may activate the File Selection Window by type Alt-M.
  283.  
  284. -------------------------------
  285. FILE (Music) SELECTION COMMANDS: (While the File Selection Window is active)
  286. -------------------------------
  287.  
  288. NOTE:  YOU MUST "TAG" A FILE IN ORDER TO PLAY IT UNLESS YOU ARE PLAYING A
  289. SINGLE SELECTION FROM THE COMMAND LINE OR A "SAVED" SESSION.
  290.  
  291. Tag  one file at a time by pressing the RIGHT ARROW key,  or <Shift>  RIGHT
  292. ARROW key.   Unshifted,  the highlighted bar will move down one file  after
  293. each tag.   Shifted,  it will move up one file.  Un-tag is exactly the same
  294. except using the LEFT ARROW key.
  295.  
  296. <Num  Lock> will produce the same effect as <Shift> Left or  Right  arrows.
  297.  
  298. Tag  all files using <Ctrl> RIGHT ARROW,  and un-tag all files with  <Ctrl>
  299. LEFT ARROW.
  300.  
  301. Pressing RETURN after selecting files will immediately begin the Play  mode
  302. and music will start.  If you press Escape after making a selection(s), the
  303. selected files will be abandoned and you will be returned to the main menu.
  304.  
  305. Additionally, if you press RETURN without selecting any files, you will be
  306. returned to the main menu.
  307.  
  308. ----------
  309. SORT FILES:
  310. ----------
  311.  
  312. Sorting is easy, just pick a number (as follows):
  313.  
  314.     1 = Sort by filename.
  315.     2 = Sort by file size.
  316.     3 = Sort by file date.
  317.  
  318. ----------------
  319. ALT + S Command: - Toggle the Request-To-Save
  320. ----------------
  321.  
  322. After selecting music from the File Selection Window, CALLIOPE will ask you
  323. if  you wish to save the music to disk so that you may replay  them  later.
  324. If you do not wish to be asked this question each time you make selections,
  325. then press "Alt+S" to turn the "Save-Request" OFF.  You may toggle it ON or
  326. OFF as desired.
  327.  
  328. If  the above command is "ON",  and you respond by pressing "Y"  (for  YES)
  329. when  asked  to save your session,  a file will be created in  the  current
  330. directory with the name "CALLIOPE.SAV".   This file will hold the names  of
  331. all  of  the currently selected songs plus a count of the total  number  of
  332. songs  in the file.   CAUTION:  IF YOU ALREADY HAVE A SAVED SESSION IN  THE
  333. CURRENT DIRECTORY,  IT WILL BE OVERWRITTEN IF YOU RESPOND WITH "Y"   (YES).
  334.  
  335. After the file hs been sucessfully saved, your current selections will play
  336. immediately.
  337.  
  338. If you do not wish to save the current session, you may press "N" (NO), or
  339. simply press the ENTER key since "NO" is the default choice.
  340.  
  341. ----------------
  342. ALT + L Command: - Load a SAVED session from disk
  343. ----------------
  344.  
  345. To play a saved session,  start CALLIOPE then press ESCape to exit from the
  346. File  Window,   then  type ALT + L.   The  music  will  start  immediately.
  347.  
  348. When  you press ALT + L,  Calliope will search the current directory for  a
  349. file named "CALLIOPE.SAV".   If the file is not found, an error window will
  350. be displayed.   If the file IS found,  the music  filenames will be  played
  351. without hesitation.
  352.  
  353. CAUTION: IF ANY OF THE FILES ARE MISSING, CALLIOPE SHOULD BE ABLE TO HANDLE
  354. THE PROBLEM AND CONTINUE.   HOWEVER ANYTHING IS POSSIBLE, SO IF THE PROGRAM
  355. STALLS, CHECK FOR MISSING FILES. IF CALLIOPE IS ABLE TO HANDLE THE FILENAME
  356. ERROR ,OBVIOUSLY YOU WILL NOT HEAR THE MISSING SELECTION(S), BUT THE STATUS
  357. WINDOW WILL DISPLAY  A "FILENAME MISSING"  MESSAGE  AND PLAY  WILL CONTINUE
  358. WITH THE NEXT SELECTION IN THE  QUEUE  IF ANY. (The error message will give
  359. you the name of the missing file so that you may take corrective action).
  360.  
  361.           During Music Play, the following commands are available:
  362.           -------------------------------------------------------
  363.  
  364. -------------
  365. PAUSE Command: (P)
  366. -------------
  367.  
  368. Pressing  "P"  will temporarily PAUSE the current music.   While  PAUSE  is
  369. active,   the  CONTINUE command is highlighted and other commands  will  be
  370. visually de-emphasized.   The elapsed time display will be blocked however,
  371. the time will continue to count-down in the background.
  372.  
  373. NOTE:  Occasionally, when you select the PAUSE command, it may get stuck on
  374. a note that refuses to be silent.  If this happens, use the "C"  command to
  375. CONTINUE  and  then use the "P"  command again until the sound  fades  out.
  376.  
  377. ----------------
  378. CONTINUE Command: (C)
  379. ----------------
  380.  
  381. Pressing "C"  will CONTINUE music, or reverse a PAUSE command.   Music will
  382. resume playing from the point that it was PAUSED.  If "C" fails, then press
  383. the SPACEBAR.
  384.  
  385. ------------
  386. SKIP Command: (S - or you may press the Spacebar)
  387. ------------
  388.  
  389. Pressing "S"  will terminate the current music and will play the next music
  390. in  the queue immediately.   You may also use this command to move  to  the
  391. next song if the current song gets "stuck"  or just stops playing (probably
  392. a corrupt file).   Skip is not available during REPLAY.  You may also press
  393. the SpaceBar to invoke this command.
  394.  
  395. The term "skip" in this instance  means that  the music was aborted during
  396. play rather than actually "skipped over" before being heard.
  397.  
  398. --------------
  399. REPLAY Command: (R) - Single INSTANT Replay
  400. --------------
  401.      - or -
  402. -------------------
  403. DOUBLE PLAY Command: (D) - Double INSTANT Replay
  404. -------------------
  405.  
  406. Pressing "R"  or "D" will instantly REPLAY the current music.   The program
  407. will  bring  you  to  the INSTANT REPLAY screen,  and  you  will  have  the
  408. opportunity  to Pause/Continue the REPLAY as you do in regular  play  mode.
  409. You cannot select the REPLAY Command (R or D)  if AutoREPLAY (A or T)   are
  410. currently active.  If you do, the word "C O N F L I C T" will quickly flash
  411. in  the  Status  Window.    This is to remind you  that  you  have  already
  412. requested a delayed REPLAY for the current selection.  If you must hear the
  413. music again NOW,  then press "A"  or "T"  to deactivate automatic mode  and
  414. then   press   "R"   or  "D"   for  Instant  SINGLE   or   DOUBLE   REPLAY.
  415.  
  416. Note  that if you decide to Exit the Replay screen with "X",  you  will  be
  417. returned to the Main Menu, and any unheard selections will be lost.   Press
  418. "Z" if you only want to cancel the current Replay.
  419.  
  420. ------------------
  421. AUTOReplay Command: (A) - DELAYED Single Replay.
  422. ------------------
  423.      - or -
  424. --------------
  425. TWO-auto-PLAY's: (T) - DELAYED Double Replay.
  426. --------------
  427.  
  428. Pressing "A"  will invoke the AutoREPLAY Mode.   In this mode,  the current
  429. song  is "flagged"  for REPLAY upon it's completion in regular  play  mode.
  430. While the song is playing,  you may cancel or reinvoke AutoREPLAY as  often
  431. as you wish by simply press "A".
  432.  
  433. Pressing  "A"  will toggle AutoREPLAY to an ON or OFF state.   You will  be
  434. advised  of  it's current status on the bottom line of the  Status  Window.
  435. All  of the same conditions found in the REPLAY screen apply here as  well.
  436.  
  437. "T"  is identical to "A"  (AUTOPLAY),  but will replay the selection TWICE.
  438. The "T" command may be toggled ON or OFF at any time.  While "T" is active,
  439. you cannot use the "H" (HIDE) command (explained later) or the "A" command.
  440.  
  441. ---------------
  442. ELAPSED Command: (E) - display the elaped session time.
  443. ---------------
  444.  
  445. -----------------
  446. "Z" CANCEL REPLAY: (Z) - Cancel a Replay (During the Replay)
  447. ------------------
  448.  
  449. After a Replay has started,  you may wish to cancel it while it is playing.
  450. Use  the "Z"  command for this.   Valid only during an Instant  or  Delayed
  451. Replays.
  452.  
  453. -----------------
  454. MUSICLOOP Command: (M) - Play the current selections forever.
  455. -----------------
  456.  
  457. Pressing "M" will invoke the MusicLOOP play mode.  In this mode, the entire
  458. music session will be replayed continously without interruption.   While in
  459. this mode,  all of the other commands are still available unless your  have
  460. invoked the "H" Hide command to blank the screen.
  461.  
  462. Pressing  "M"  will toggle MusicLOOP to an ON or OFF state.   You  will  be
  463. advised  of  it's  current status on the bottom line of  the  screen.    In
  464. addition,  the current Loop Number will be displayed.  Pressing "F"  or "X"
  465. will  also terminate the MusicLOOP mode.   While MusicLoop is active,   the
  466. Session  Tracking  graphic at the top of the screen  will  be  deactivated.
  467. However, "Current Music" Tracking will continue.
  468.  
  469. ------------
  470. HIDE COMMAND: (H) - Screen Saver for "marathon" MusicLoops.
  471. ------------
  472.  
  473. Pressing "H"  will blank the screen provided that MusicLoop is ACTIVE.   To
  474. return to your normal display simply press any key.   Note that you  cannot
  475. invoke  the  Hide  command  if  a  Single  or  Double  Replay  is  pending.
  476. This command will prevent phosper burn-in in case you fall asleep with your
  477. earphones on and wake up on Thursday.
  478.  
  479. ---------------------
  480. KEYS 4 thru 9 commands: - Looking deeper into the music queue.
  481. ---------------------
  482.  
  483. While the music is playing, the next  three songs in  the  Queue  will  be
  484. displayed in the Queue window.  If you have selected more that three songs,
  485. then you may press NUMBER KEYS One through Nine (1-9)  to view the name  of
  486. the song which currently occupies THAT position in the queue, up to the 9th
  487. selection.
  488.  
  489. ---------------------------
  490. FILE WINDOW  [Exit] Command: (F)
  491. ---------------------------
  492.  
  493. Pressing "F" will terminate CALLIOPE's music play mode and return you to to
  494. the  FILE SELECTION WINDOW where you may select more songs to play or  exit
  495. to  the  Main  Menu.   This command will  terminate  MusicLOOP  if  active.
  496.  
  497. ------------
  498. EXIT Command: (X - or you may press the ESCape Key)
  499. ------------
  500.  
  501. Pressing  "X"  will shut down CALLIOPE's music play mode and return you  to
  502. the  main menu.   On the other hand,  when the last song has  been  played,
  503. CALLIOPE will exit the Play Mode and return you to the main menu.   At that
  504. point  the,   the File Selection Window will pop-up  automatically.    This
  505. command will terminate MusicLOOP if active.   You may also press the Escape
  506. key to invoke this command.
  507.  
  508. -------------------
  509. ENDING THE PROGRAM: (ESC - from main menu)
  510. -------------------
  511.  
  512. Pressing  ESCape from the main menu will terminate CALLIOPE and return  you
  513. to the DOS prompt (assuming the File Selection Window was not active).   If
  514. the File Selection Window is active, pressing ESCape 3 times will terminate
  515. CALLIOPE,   and  return you to the DOS prompt while displaying  a  low  key
  516. share- ware screen and session statistics.
  517.  
  518. ------
  519. ERRORS:
  520. ------
  521.  
  522. If the Status Window displays "FILENAME.MDI Missing",  then THAT  selection
  523. could  not be found in the current directory,  and as a result was  skipped
  524. over.  This could happen if you erase or rename one or more song files from
  525. your  CALLIOPE Directory  and subsequently LOAD a "Saved"  session.    When
  526. CALLIOPE looks for the missing file to load and play...Oops.., but CALLIOPE
  527. is smart enough to handle most errors of this type and will simply continue
  528. with the next selection.   The Status Window will advise you of the name of
  529. the missing file if this type of error ever occurs.
  530.  
  531. If a music file gets "stuck" at it's termination point and attempts to loop
  532. itself and start over, CALLIOPE will force it to terminate, and display the
  533. message "filename was PUSHED" in the status window.  "PUSHED"  means it was
  534. forced  off  of the queue by the CALLIOPE Police who constantly  watch  for
  535. this   sort   of   behavior.    Most  likely  you  will   never   see   it.
  536.  
  537.                              Some important notes:
  538.  
  539.  o  If the length of your path is exceeds 18 characters, only the last
  540.     18 characters will be displayed.
  541.  
  542.  o  All graphics are text based and therefore do not require a VGA monitor.
  543.     However, the program was created on a system with a VGA monitor.
  544.  
  545.  o  A music file larger that 65,520K will force an error condition, in
  546.     which case you will be advised and returned to the main menu.
  547.  
  548.  o  Sometimes when a music file suddenly stops playing, it may be corrupt.
  549.     Reconvert it from your original .ROL file and try again.
  550.  
  551.  o  CMV was created on a 386 16Mhz system, running DOS 5.0 with 640k
  552.     memory.  The sound card was a Sound Blaster v1.5 (original).
  553.     Programming language: QuickBasic version 4.5
  554.  
  555.  
  556.                             Version History
  557.  
  558.     Version 1.0  = April 1992 release.
  559.     Version 1.1  = Added bar graph/new screens. Ensure file size within limits.
  560.     Version 1.2  = Bug fix and reduced memory usage. Official release.
  561.     Version 1.3  = Added "F" command to access File Window from Play Mode.
  562.     Version 1.4  = Music Queue now displays the next 3 songs in the Queue.
  563.                    Added "Estimated Time" (minutes) for all songs to play.
  564.                    Enhanced error checking while each song plays.
  565.                    Removed the limited mouse support.
  566.                    "Any key" will now bypass the opening screen.
  567.                    Added "R" for Instant Replay.
  568.                    Added "A" for delayed automatic Replay.
  569.                    Added various corrective/functional/cosmetic screen updates.
  570.                    Additional stats upon exit from the program.
  571.     Version 1.5  = Added command line option to play a single selection.
  572.                    Added command line option to silence speakers.
  573.                    Added MusicLoop continuous play mode.
  574.     Version 1.6  = Added "H" Hide screen display. "Z" cancels a Replay.
  575.                    "T" invokes a delayed Double Replay. "D" invokes an instant
  576.                    Double Replay. Number keys 4 thru 9 to view deep queue.
  577.                    Added Session Tracking graphic. "E" elapsed time.
  578.                    Save Session to disk.  Load Session from disk.
  579.                    Toggle SAVE request window.
  580.     Version 1.7  = Enhanced Save/Load Session option.  Filename EXTENSION is
  581.                    now optional on command line play. (1/93)
  582.                    Save unlimited multiple sessions with any valid filename.
  583.                    Added popup session selection window (Point-and-Play)
  584.                    Minor screen enhancements.
  585.     ---------------------------------------------------------------------
  586.     Questions or problems? My direct FAX number is (516) 538-2633.
  587.  
  588.     The latest version of CMV may be found on the following bulletin boards:
  589.     ---------------------------------------------------------------------
  590.                 1 -  The Executive Network BBS, New York
  591.                      914-667-4684 all baud speeds
  592.     ---------------------------------------------------------------------
  593.  
  594.                 2 -  The Invention Factory, New York
  595.                      212-274-8930
  596.  
  597.                 3 -  Computer Connection, Washington, D.C.
  598.                      202-547-2008
  599.  
  600.                 4  - Vernon Buerg's BBS, Calif.
  601.                      707-778-8944
  602.  
  603.                 5  - Gene Plant's BBS, Illinois
  604.                      708-843-2772
  605.  
  606.                 6  - The SoundBlaster Digest BBS, Toronto
  607.                      416-840-2485
  608.  
  609.         Special Thanks to Ro and Joe Malacria, and Dennis Anderson...
  610.         ...and Executive Network BBS, the BEST international bulletin board.
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.